Skip to main content

Add Profile

Route

/v2/streaming/profiles

Description

Create a new streaming profile with the provided configuration. Profiles define what data to stream and how to stream it.

Method

POST

Inputs

ParameterTypeRequiredDescription
namestringYesHuman-readable name for the profile
descriptionstringNoDetailed description of the profile
sourcesarray[Source]YesData sources to stream
destination_idstringYesTarget destination ID
count_thresholdintegerNoBatch size threshold (ignored for streaming destinations)
delay_thresholdstringNoBatch delay threshold (e.g., "10s")
statestringNoProfile state (active, stopped, paused)
scope_idstringNoScope identifier
configobjectNoProfile configuration

Request Body

{
"name": "Security Events Stream",
"description": "Stream security incidents to SIEM",
"sources": [
{
"type": "incidents"
}
],
"destination_id": "dest-456",
"count_threshold": 1000,
"delay_threshold": "10s",
"state": "active",
"scope_id": "scope-789",
"config": {
"include_ai_summary": true
}
}

Output

FieldTypeDescription
resourcesarray[Profile]Array containing the created profile
errorsarray[Error]Any errors encountered

Rate Limit

  • 60 requests per minute per API key
  • 5 concurrent requests per endpoint

Example Response

{
"resources": [
{
"id": "profile-123",
"name": "Security Events Stream",
"description": "Stream security incidents to SIEM",
"sources": [
{
"type": "incidents"
}
],
"destination_id": "dest-456",
"count_threshold": 1000,
"delay_threshold": "10s",
"state": "active",
"dead_letter_state": "ready",
"scope_id": "scope-789",
"config": {
"include_ai_summary": true
}
}
],
"errors": []
}